home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_4 / nsclk170.lha / NISClock.readme < prev    next >
Text File  |  1995-05-27  |  7KB  |  171 lines
  1. Short: Many Options. Vanishes for Prefs change.
  2. Uploader: John D. Muir <John_Muir@UManitoba.Ca>
  3. Author: John D. Muir <John_Muir@UManitoba.Ca>
  4. Type: util/time
  5.  
  6.                          NISClock 1.70 (27.5.95)
  7.                         ⌐ Copyright 1995 John Muir
  8.                            Written by John Muir
  9. ___________________________________________________________________________
  10. Introduction
  11.  
  12. NISClock is a small clock program that uses a minimum amount of CPU time
  13. since it only updates the clock every minute (or every second if you
  14. wish).  It can make use of Stephan Becker's screennotify.library which
  15. patches a few intuition.library functions so that the clock will
  16. automatically close its window if the Workbench screen is removed by
  17. IPrefs for a preferences change or by any other program which calls
  18. CloseWorkbench().
  19.  
  20. ___________________________________________________________________________
  21. Requirements
  22.  
  23. - Requires V37 (2.04) of the Amiga OS, but can use V39 features.
  24. - Optionally uses screennotify.library by Stephan Becker.  See
  25.  'Installation' for more information on screennotify.library.
  26. - NISClock must be run from the Workbench.
  27.  
  28. ___________________________________________________________________________
  29. Installation
  30.  
  31. With the workbench, you can just copy NISClock to the WBStartup drawer to
  32. have the program execute as you boot-up.  If you have a 68020 or better,
  33. you can use NISClock020 instead.
  34.  
  35. screennotify.library by Stephan Becker must be installed in LIBS: or
  36. PROGDIR: (the directory where NISClock is started from).  Get
  37. screennofity.library from the distribution archive on AmiNET:
  38.  
  39. /pub/aminet/util/libs/ScreenNotify10.lha
  40.  
  41. screennotify.library is also available in the latest ToolManager
  42. distribution archive(s) which I recommend highly;
  43.  
  44. /pub/aminet/util/boot/ToolManager21?.lha
  45.  
  46. ___________________________________________________________________________
  47. Usage
  48.  
  49. NISClock will only run from the Workbench and it supports the following
  50. tooltypes;
  51.  
  52.   SECONDS - Boolean; true when the tooltype exists.
  53.        - display seconds when true.
  54.  
  55.   24HOUR - Boolean
  56.        - display the time in 24 hour mode.
  57.  
  58.   INTITLEBAR - Boolean
  59.        - display the time in the title bar colours, otherwise a box
  60.         is drawn on the edge of the window to match the depth gadget.
  61.        - NOTE: V37: Backpen = 2 (White) and FrontPen = 1 (Black).
  62.  
  63.   FULLYEAR - Boolean
  64.        - display the year part as YYYY.
  65.  
  66.   TIMEDATE - Boolean
  67.        - display the date and time at the same time.
  68.  
  69.   LEFTEDGE - Numeric; eg: LEFTEDGE=400
  70.        - the value represents the left edge of the NISClock window.
  71.        - -1 for default position.
  72.        - the window cannot be positioned with the mouse, so make good use
  73.         of the file notificaiton on NISClock.info! :)
  74.  
  75.   DATEFORMAT - Enumerated; eg: DATEFORMAT=DDMMYY
  76.        - display the date in the requested format;
  77.         DATEFORMAT = DDMMYY (default), MMDDYY or YYMMDD.
  78.  
  79.   JUSTIFICATION - Enumerated
  80.        - display the time and/or date with justification;
  81.         JUSTIFICATION = CENTER, RIGHT, LEFT, or NONE.
  82.        - NONE means RIGHT when INTITLEBAR is ON, and CENTER otherwise.
  83.  
  84. NISClock will automatically update itself if the icon tooltypes are
  85. changed.
  86.  
  87. A mouse click on the NISClock window will cause the date to be displayed
  88. unless TIMEDATE is true.  Additional Clicking will toggle between Time and
  89. Date.  The Time will automatically reappear after 4 seconds.
  90.  
  91. To STOP NISClock, simply run the program again.
  92. NISClock WILL NOT RUN without screennotify.library.
  93. NISClock WILL NOT RUN from the CLI.
  94.  
  95. ___________________________________________________________________________
  96. Comments? Talk to me!
  97.  
  98. EMail:     John D. Muir <John_Muir@UManitoba.Ca>
  99.     or     John Derek Muir <ummuir05@cc.umanitoba.ca>
  100.  
  101. Snail Mail:
  102.     John Muir
  103.     3-152 Guigues Ave.
  104.     Ottawa, ON
  105.     K1N 5H9
  106.     CANADA
  107.  
  108. ___________________________________________________________________________
  109. History
  110.  
  111. 0.99 - Released to IRC for testing.  Tested on OS2.x and OS3.x.
  112. 1.0  - Released to AmiNET. 68000 version compiled... (oops! :)
  113. 1.1  - Now displays the date with a mouse click on the Window.
  114.      - Date disappears after 5 seconds.
  115.      - Fixed a few bugs.
  116. 1.2  - Reduced Code Size.
  117.      - Date disappears after 4 seconds now.
  118.      - Date is displayed in standard DD.MM.YY, 0s removed.
  119. 1.2a - BUGFIX: 10 o'clock now shows the 1...
  120. 1.3  - Added the tooltypes; SECONDS, 24HOUR, INTITLEBAR
  121.      - INTITLEBAR requires intuition.library >= V39.
  122. 1.4  - Added the DATEFORMAT tooltype.  See "Usage" for more.
  123.      - INTITLEBAR no longer requires V39.  Pens 1 and 2 are used as
  124.       foreground and background respectively.
  125. 1.5  - JUSTIFICATION tooltype added. (NONE, LEFT, RIGHT, or CENTER) RIGHT
  126.       is the default for INTITLBAR=1, while CENTER is the default for
  127.       INTITLEBAR=0.
  128.      - FULLYEAR causes YYYY to be displayed instead of YY.
  129.      - TIMEDATE causes the time and the date to be displayed at the same
  130.       time.
  131.      - 68030 Compilation included.
  132.      - The icon is a NewIcons icon. Thanks to Gavin Hamil.
  133. 1.51 - Small Code optimizations -> 76 byte reduction.
  134. 1.60 - Oops... I forgot that the revision number is not decimal..
  135.      - You can now position the window using the LEFTEDGE tooltype.
  136.      - Reworked the USAGE section of the .readme file.
  137.      - Including an '020 compilation instead of '030 since they are the
  138.       same size.
  139. 1.61 - Size optimizations.  '020 version is now under 4k!!
  140. 1.62 - BUGFIX: Now the program does not try to reopen its window 5 seconds
  141.       after being notified of a Closed Workbench.  Although NISClock opens
  142.       on the Default public screen, it is a good idea to make it run on the
  143.       Workbench screen, because otherwise it may cause problems with other
  144.       programs such as Directory Opus.  Maybe I'll implement opening on a
  145.       PUBSCREEN of choice..
  146.      - BUGFIX: ToolTypes can now be turned off with icon notification
  147.       after the program has been running. (Notification worked, but you
  148.       couldn't turn off the options... ;)
  149.      - Size optimizations.  Lost 112 bytes (116 for '020 version).
  150. 1.70 - No longer requires screennotify.library.
  151.      - BUGFIX: Defaults for JUSTIFICATION and DATEFMT are now set properly
  152.       if the tooltypes aren't found.
  153.      - Handles other public screens properly, if you should manage to get
  154.       NISClock on a screen besides Workbench. ie; NISClock will close its
  155.       window if the Public Screen is closed.  Provided you are using
  156.       screennotify.library of course.
  157.      - Two spaces between Date and Time when TIMEDATE is set.
  158.      - WARNING: Do not use screennotify.library and ScreenTab at the same
  159.       time if you have windows that subscribe to screennotify.library
  160.       (NISClock) on OTHER public screens (besides Workbench) or intuition
  161.       will Dead-Lock.
  162.  
  163. ___________________________________________________________________________
  164. To Do - Let me know if you have a favorite or suggestions.
  165.  
  166.      - PUBSCREEN of your choice. (maybe)
  167.      - Localization; time and date are displayed in the format specified
  168.       by your locale.  (v2.0)
  169.      - The weekday written. <- localized.  (v2.0)
  170.      - The month written. <- localized.  (v2.0)
  171.